BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / qbbs / profile.zip / PROFILE.DOC < prev next >

Wrap

Text File | 1991-06-23 | 55KB | 1,075 lines

▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀ ▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀ ▀▀▀▀▀ ▀▀ ▀▀▀ ▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀▀▀▀ ▀▀▀ ▀▀ ▀▀▀▀▀ ▀▀ ▀▀▀ ▀▀ ▀▀▀▀▀ ▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀ PROFESSIONAL FILE SYSTEM FOR REMOTE ACCESS BULLETIN BOARD SERVICES WRITTEN BY: STEVE BARBER ***************************************************************** ** ** ** PRO-FILE Professional File System ** ** For Use with Remote Access Bulletin Board Systems ** ** ** ** Written By Steve Barber ** ** The Gamer's Connection BBS ** ** (615) 391-4807 Nashville, TN ** ** (615) 883-8674 Voice ** ** ** ** Version 1.0 ** ** Released on: July 1st, 1991 ** ** ** ** (C)opyright 1991, Steve Services ** ** All Rights Reserved ** ** ** ** Written and Compiled in Turbo Pascal 5.5 ** ** ** ****************************************************************** ** INTRODUCTORY NOTE ** This manual covers every aspect of this software in great detail. If you want to jump right in, the recommended reading is: - Read Carefully the Introduction and FOUNDATION sections following. - Read the PRO-FILE DataBase Information. - In the Management Tools Section, scan the name and purpose of each function to become aware of everything PRO-FILE offers. - Scan the AUTO DRIVE feature information. - Installation Instructions are provided at the close of the document. INTRODUCTION -------------- PROFILE Professional File System is a complete File Management System for Remote Access Bulletin Board Services. It is complete in every detail and offers everything you need to easily manage a professional file system. Among all the vast features, the highlights include: * A Colorful Environment and Overall Professional Appearance. * Easy to Use Interface and Help from within the Program. * A Compact but Informative File Database - The heart of PRO-FILE. * A Conversion Utility that will convert Wildcat's System to PRO-FILE's. * An International First: Extremely EASY Access to EVERY command and function From the Command Line. * All Tools necessary to manage and maintain an RA File System. * And of course, the principal function of PRO-FILE: Professional and Eye-catching Files Listings complete with 2 Line Descriptions, Download Count, and Rating, that will for the first time ever replace the dull listings that RA provides. * In addition, a complete program in itself is included: an on-line door that will allow users to view yet even more information on a file including the uploader, last date of download, and estimated transfer time of a selected file. * Voice phone support direct to the author. Because of the incredible amount of functions and uses PRO-FILE has, it may seem complicated and overwhelming at first, but if you will take just a few minutes to carefully read and understand the FOUNDATION section, you will have a clear understanding of what PRO-FILE is and how to use it. WARRANTIES ---------- There are none. Use at YOUR own risk. The software and all accompanying materials (including documentation) are provided "as is" without warranty of any kind. The author does not warrant, guarantee, or make any representations regarding the use or misuse of this software, or written materials in terms of correctness, accuracy, reliability, currentness or otherwise. The author shall not be held liable for any direct, indirect, consequential, or incidental damages of any kind arising from the use of this software. Every attempt has been made to deliver a working program and accurate documentation. DISTRIBUTION ------------ PRO-FILE has been distributed as Shareware. You may use this software for a length of time you deem fit for a short evaluation. You must register if you wish to continue usage. This software may only be distributed as a whole and with NO modifications. COPYRIGHT LAWS -------------- This software and all accompanying materials are protected under United States Federal and International Law. All Rights Reserved. *** The following section is basically a summary of this whole manual. I promise you that if you'll take the time to read it, you will end up using PRO-FILE <AND> thanking yourself for taking the time to download and becoming acquainted with this software. *** FOUNDATION ------------ If you downloaded this package thinking it will allow you to replace those dreadful RA file listings with a new set of colorful, informative, and unique listings, you're right, but you also downloaded a lot more than you bargained for. PRO-FILE is not only an innovative utility that will for the first time replace the dull and minimal RA file lists, it is a Complete and Professional File Management System designed to give you full and easy control over managing the file portion of an RA BBS. To avoid some confusion head on, PRO-FILE is not a door like FileDoor or GDoor, it is a Management System. PRO-FILE generates unique and professional file lists viewable on-line. It does this by writing both an ASCII and an ANSI file list to disk as text files, not by loading a door. Thus, users will be able to view the file lists instantly, as opposed to the file doors that take 10 seconds to load and return. You might have realized by now that some menu adjustments must be made, but don't worry.. installing PRO-FILE is a snap even for beginning SysOps. The beauty of it all is that if desired, you will not need a separate file menu and screen for each area. The foundation of the complete PRO-FILE package is its Database. As you may know, the Files.BBS files contain file information that RA needs to generate listings. For a typical RA BBS, the Files.BBS is the heart of the file system. The typical RA BBS probably needs a program such as Fido-Fam that manipulates the Files.BBS files and allows the deletion or addition of files, and if you're lucky, maybe even the transferring of files from one area to another. Thus, the heart of information for those programs is a flimsy text file which contains only the minimal requirements for RA file listings. PRO-FILE, alternatively uses a powerful Database technique to process and gather a wealth of information. The PRO-FILE Database goes beyond the minimal information. It supports extended information such as the uploader, number of downloads, last date of download, rating, status, and more for each file. PRO-FILE uses Files.BBS for one function only - new uploads. Once PRO-FILE has gathered the information of a new file, it's there to stay regardless whether the file is on disk or if the Files.bbs is present or not. All information is kept in the PRO-FILE database. If you decide to add, delete, or transfer files, PRO-FILE not only makes the changes to disk, but also performs all other steps needed (including updating RA, the Files.BBS files, and file lists). ** So Far, I hope it is now common knowledge to you that: 1) PRO-FILE is not a door. 2) PRO-FILE generates unique listings, that for the first time will replace the standard RA listings. It does this by generating ASCII/ANSI files the user will view on-line like a text file. 3) Some editing to the current file menu(s) is required but PRO-FILE will ease this already easy process. 4) The heart or foundation of PRO-FILE is a database, not a flimsy text file like Files.BBS. 5) The PRO-FILE database stores extended file info such as the uploader, last date of download, rating, and more, for each file. 6) If you decide to add, delete, or transfer files or areas, the changes will be made not only to the database, but to RA and/or disk also - Everything's automatic and taken care of. Now that you are familiar with PRO-FILE's foundation, it's highlights, and how it differs from other programs, the final part of the Foundation section will briefly describe the steps needed to generate listings and manage a professional file system, AND WHY. Before you get started with PRO-FILE, you need to know how to get around and use PRO-FILE and what steps are needed to accomplish certain tasks. The environment of PRO-FILE is eye-pleasing and easy to use. PRO-FILE does not use a pull down menu interface. While these interfaces are increasingly popular and neat to look at, most of the functions of the program are hidden and scattered from menu to menu. PRO-FILE has one menu, the Main Menu. From the main menu, every command and function is listed along with it's corresponding hot-key. All functions can be executed by pressing a key or key combination. Most of the hot-keys have letters that relate to the function performed. For example, to (D)elete a file, you would press Alt-D, or to (S)earch for a file, you would press Alt-S. If you have any problems, Help is available from within the program. PRO-FILE allows you to easily manage your file system by giving you all the necessary tools. You can use PRO-FILE to add, delete, or transfer a file or a group of files. PRO-FILE conveniently and automatically takes care of all new uploads. While PRO-FILE functions as a complete file management system, its primary function is to generate professional file listings for RA. This process is completely automatic, but you should know what steps PRO-FILE takes and why. PRO-FILE generates a file list for each file area by writing an ASCII/ANSI text file in your RA text files directory. This means all area listings are in one directory. The file names of the area lists are represented by letters (A-Z). Area A has FilesA.ASC/ANS, Area B has FilesB.ASC/ANS, all the way up to Area Z which has FilesZ.ASC/ANS. Remember, all file lists are placed in your RA text files directory, the same directory that contains high score files for games, readable BBS lists, and bulletins. Ok, when I get PRO-FILE set up and the file lists are created, how do the users view them? First, you must make some minor adjustments to your file menus. In brief, what you'll have to do is replace the Type 31 (List Files) with a Type 5 (List ASC/ANS Text File). This is discused in detail further on in the manual. Once you've got everything adjusted and PRO-FILE has generated all the file listings (remember, they're really text files), when the user hits L, F, or the key you have assigned to the Type 5 command, the new PRO-FILE file list will be displayed instead of the dull RA listing. Your users will probably notice the change and like it, while other RA sysops will become baffled and jealous and will probably leave you a message inquiring how in the world you (well, you get the picture). Ok, when the file lists are created and I'm getting a whole lot more users... now, how do I update the file lists? When new files are uploaded, the filename and description are inserted in the files.bbs file in the area where the user uploaded it. When PRO-FILE loads, it scans all areas where uploads are allowed and adds new file information automatically. Next, an activity log scan must be used to retrieve additional file information. Now the database is completely updated, the file lists must be generated, which is automatically taken care of upon exit of PRO-FILE. All this is completely automatic when PRO-FILE is run in AUTO DRIVE (more on this subject later.) ** By now, I hope you also know: 7) Instead of a pull-down menu system, PRO-FILE uses a system where every function is accessible by pressing a hot-key and all functions are listed at the main menu so you don't have to search to find out what key to press. 8) Help is available from within the program by pressing Alt-H. 9) Most keys used to execute a function are related to the function's name, such as Alt-D to (D)elete a file or Alt-H for (H)elp. 10) PRO-FILE offers all the tools needed to manage a Professional File System. 11) Yes! PRO-FILE can be run in Automatic Mode once you've got it set up right and will take care of everything for you. 12) All the complex and multi-staged steps to update the database and generate file lists are handled automatically. Well, those are the Twelve Steps that should familiarize you with PRO-FILE and make the File Portion of your BBS life a whole lot easier. If you still don't have a clear idea of what's going on, look over the Twelve Steps once more. PRO-FILE DATABASE INFORMATION ------------------------------------- The PRO-FILE Database is stored entirely in one file called called Files.Bnk and is located in your PRO-FILE directory. Before you start using PRO-FILE, you must Initialize a new Database (Alt-I). More information on the Initialize Function can be found in the MANAGEMENT TOOLS SECTION following. Once you have created your Database, it will be time to add all the file information. If you just happen to be changing BBS software from Wildcat to RA and still have the Wildcat File Database (FileSpec.Dat), you can use the included utility WMerge, to convert Wildcat's system to PRO-FILE's; however, because Wildcat's database does not have as much information as PRO-FILE's, some information must be entered manually. If you are using RA or converting from another BBS that used Files.BBS, all all information will be added automatically when you load PRO-FILE for the second time. Although a generous amount of information can be gathered through this process, no extended info PRO-FILE supports can be gathered. You must enter the extended information yourself. Once you have setup your database with all your file info, you will be ready to go. You need to be aware of a few customs PRO-FILE uses with its Database. Most the time when the manual or PRO-FILE refers to a file, it is referring to a file's information, not the file on disk. When you delete a file (the file information), that file becomes inactive in PRO-FILE. This means it still exists, the information just won't be shown in listings. If you want to permanently and physically remove a file, you must first delete it (so it will become in-active), and then Pack the Database (Alt-P). All this information is listed below, but you need to be acquainted with PRO-FILE's "In-Active" method of deleting files. PRO-FILE MANAGEMENT TOOLS --------------------------------- This section describes in great detail, all the tools PRO-FILE offers. Keep in mind that each of these functions handles everything. Most functions go through a series of complex steps to accomplish the mere title of the function. Each function in PRO-FILE is described below in this format: ** (HOT-KEY): WHAT IT DOES -------------------------- FUNCTION: What this function does. PURPOSE: Why and when to use this function. PRECAUTIONS: Any information you should be aware of, ranging from warnings, to recommendations and reminders. INPUT: The options available, and what you must type in and do. PROCESSING: Steps taken to accomplish the function. (Mainly disk I/O) NOTES: Any additional information is listed here. ** ALT-A: ADD A NEW FILE ------------------------ FUNCTION: Allows you to manually add a file. PURPOSE: Use when you just want to add one individual file. Use only for adding files that have not been uploaded. PRECAUTIONS: None. INPUT: You will need to enter the new file information. If the file is found in the specified area, the file size and date will be picked up automatically. PROCESSING: PRO-FILE first scans the database for any in-active files and if found will overwrite the in-active file with the new file's info to save space and time. ** ALT-C: ACTIVITY LOG SCAN --------------------------- FUNCTION: Scans the RA Activity Log to gather updated information. PURPOSE: Use this daily to maintain up to date information. PRECAUTIONS: After the scan is complete, make sure and either delete or append the log file. (See Below) INPUT: You have the option to delete, append, or keep the log file. PROCESSING: After scanning, if the log file is to be appended (the recommended choice), then it will be appended to a file named OldRA.Log (located in the PRO-FILE Dir, Not RA) which contains previous log files. The OldRA.Log can be deleted at any time. NOTES: If you do not delete or append the log file, there is a high possibility that the download counts of recently downloaded files will be inaccurate (too high). All previous logs can still be viewed in OldRA.Log. Also, PRO-FILE supports both Frontdoor and Opus style logs. ** ALT-D DELETE A FILE ---------------------- FUNCTION: Allows you to delete a file's information, and if desired, the physical file itself will be removed from disk. PURPOSE: Use this when you want to delete only one file at a time. PRECAUTIONS: If you choose to have the file removed from disk, remember, PRO-FILE can not recover the file itself, just the information in the database INPUT: You must enter the filename and decide if you want to have the file removed from disk. PROCESSING: The selected file's information becomes in-active and will not be shown in listings. NOTES: If you accidentally delete the wrong file, you may be able to recover the file's information by Un-Deleting it. ** ALT-E: EDIT A FILE'S INFORMATION ----------------------------------- FUNCTION: Allows you to edit a file's information. PURPOSE: Use this to change the information of a file. PRECAUTIONS: None INPUT: You may change any and all file information desired. PROCESSING: The file's new or updated information is saved in the Database, and if needed, disk processing is taken care of. ** ALT-F: GENERATE FILES.BBS FILE(S) ------------------------------------ FUNCTION: Generates the Files.BBS File(s). PURPOSE: This function is only provided as a means of correcting a problem with the files.bbs files if it every occurs. You will probably never have to use this. PRECAUTIONS: None INPUT: You may choose to update one or all areas' files.bbs files. PROCESSING: When the files.bbs files are generated, the file is completely wiped out and then rewritten with the information PRO-FILE has for the area. NOTE: The generating and updating of Files.BBS files are automatically taken care of by PRO-FILE when needed. You will seldomly or never have to use this function. Because the demand for Files.BBS by RA is not as great when using PRO-FILE, only one line of the description will be entered in Files.BBS to conserve disk space. ** ALT-G: GENERATE AREA FILE LISTING(S) --------------------------------------- FUNCTION: The primary function of PRO-FILE - This generates area listings (viewable via text files). PURPOSE: This function is processed and used automatically by PRO-FILE when needed. You will probably never need to use this function manually. PRECAUTIONS: None INPUT: You may generate just one area listing or all area listings. PROCESSING: For each individual area, a file list is generated. These files lists are placed in the RA text files directory. There are two file lists flavors for each area - an ASCII (B&W) file and an ANSI (Color) file. The file lists are named by area. All file lists names start with "FILES" and then the area letter is added(ex: FILESA). Last, the extension determines the flavor (FILESA.ASC for B&W, or FILESA.ANS for Color) . ** ALT-I: INITIALIZE OR EDIT A DATABASE --------------------------------------- FUNCTION: Initializes a brand new database or allows you to edit the area information of an existing database. PURPOSE: Use this to set up the PRO-FILE database before you do anything else. If you've already set up a database and want to edit area information (such as area names or file paths) or want to add or remove complete areas, you can use this function to change area information. PRECAUTIONS: PRO-FILE protects you from accidentally initializing a new database over an existing one. The only thing you need to be careful of is removing areas. When you remove an area, it's file information is completely erased from the database and can not be recovered. INPUT: If you are initializing a new database, everything is automatic. If you are editing area information of an existing database, you will be allowed to edit existing area names and file paths. PROCESSING: If initializing a new database, PRO-FILE will scan Files.RA to obtain all the area information; thus everything is automatic. If an area is to be removed, then PRO-FILE will completely erase all file information pertaining to that area and its files, and if selected, all the area's physical files on disk will be removed. Any changes in area information will also be made to RA for your convenience. NOTE: This function deals solely with area information and has nothing to do with File information except through the removal of areas. ** ALT-K: UPDATE FROM DISK -------------------------- FUNCTION: Automatically adds new files and optionally updates file info if any changes to the files on disk have been detected. PURPOSE: This is chiefly used for adding complete new areas at once. It can also be used to update the database if any changes to physical files have occurred (ex: file date or size has changed). PRECAUTIONS: All files in the specified area that do not already exist in the database will be added EXCEPT Files.BBS. This means ALL files in the area will appear in the listings. Be careful if there are any files in the area directory you do not want added, then don't use this function. INPUT: You will have several options available. All new files will be added automatically. For all new files, you have the option of adding a description, or if you specify, no description will be added. In addition, you have the option of having PRO-FILE update the database to any file changes (such as in file date or size). PROCESSING: All new and updated information will be added to the database. ** ALT-L: GLOBAL BY AREA ------------------------ FUNCTION: This powerful and convenient feature functions more as a sub-program than just another feature. It allows you to make changes to multiple files at once instead of individual files one at a time. PURPOSE: This will probably serve as your primary management tool. This one function combines all the individual management tools into an easy to use environment. You can delete, un-delete, transfer, or set the download count or rating for several files at once. You may also edit a file's information just by selecting it. All this is done by marking files and then selecting an action to perform on all marked files at once. PRECAUTIONS: None - Easiest and Most Convenient Function in PRO-FILE. INPUT: You'll be given an alphabetized list of all files in the selected area. Use the cursor keys to select the desired file(s). To mark a file, press the space bar on the file and you'll notice a star to the left to indicated it's been marked. Press the space bar again to unmark it. To view information of the highlighted file, press V. To edit a file, press E. When you're finished marking files, press Enter to perform the global functions. Files colored in pink are in-active. Press Escape to go back to the main program when finished. PROCESSING: This function is a processing factory. NOTE: Try your best to become familiar with this function, as it will practically eliminate the need to use the other management tools and is far more convenient. ** ALT-N: UN-DELETE A FILE -------------------------- FUNCTION: Allows you to Un-Delete file information or make it "Active" again. PURPOSE: Use this if you've accidentally deleted the wrong file or want to make "in-active" file information appear in listings again. PRECAUTIONS: Be sure to use this function directly or soon after you've deleted the file you want to recover. Keep in mind that you can not recover any files after a pack has been performed. This function can not recover files from diskk. INPUT: Enter the filename and PRO-FILE will take care of the rest. PROCESSING: If you enter a filename that still exists in PRO-FILE, then it will become active again. Note again that the physical file on disk can not be recovered through this process. If the file information has been rewritten, then you will not be able to recover the information either. ** ALT-P: PACK DATABASE ----------------------- FUNCTION: Packs the database by completely removing the file information of in-active files. PURPOSE: Use this if you have a lot of in-active files and are desperate to conserve disk space. There are advantages and disadvantages to this process. Obviously, the advantage is that it will decrease the size of the database by completely removing "in- active" file information, and thus will increase disk space. The disadvantage is that adding files will take longer. This is because when adding files, if PRO-FILE can find an in-active file, it will overwrite it and not have to search the entire database. If no in-active files exist, the an entire search must be performed before adding each file. PRECAUTIONS: You will no longer be able to recover in-active files when this process has been completed. INPUT: This routine is purely automatic. No input is required except to verify the process. PROCESSING: All in-active file information will be completely removed and a new database will be written to reflect the changes. ** ALT-S: SEARCH FOR A FILE --------------------------- FUNCTION: Performs a complete search and displays a file or files matching a search specification. PURPOSE: Use this if you don't know what an exact name of a file is, or want to verify that a file exists. PRECAUTIONS: None INPUT: If you just want to verify that a file exists, enter the complete file name and you'll be told whether it exists or not; otherwise, if you enter a partial name, all filenames containing your search spec will be listed. PROCESSING: A complete search will be performed through the entire PRO-FILE database. NOTE: If and only if ONE EXACT match is found, then the filename will be stored in a buffer that can be called by pressing F9. For example, say you search for PROFILE.ZIP and an exact match is located, then you can press Alt-V to view or Alt-E to edit a file and when it asks you for the filename, you can press F9 to enter the previous filename found in this search. ** ALT-T: GENERATE TOTAL LISTING -------------------------------- FUNCTION: Generates a master files list (ASCII and ANSI flavors). PURPOSE: Use this to generate a master files list of all areas. You may specify for the complete list to be placed in your RA text files directory or placed automatically in a file area in which case the database will be updated of the new or updated file. PRECAUTIONS: It would be wise to perform an Activity Log Scan before generating the master list so it will contain all latest updates. INPUT: You have the option of placing the list in the RA text files directory or in a file area. PROCESSING: Both an ASCII and ANSI Master File Lists will be generated in the specified location and will be named "ALLFILES.LST" and "ALLFILES.ANS". If the lists are placed in a file area, then the database will be updated for the current size and file date of the listings. The area listing that contains the master list will show the ASCII list only. NOTE: This feature is available only in the Registered Version. ** ALT-U: SET-UP OPTIONS ------------------------- FUNCTION: Allows you to configure the PRO-FILE start-up procedure. PURPOSE: Use this to change set up options such as the update method used when PRO-FILE loads. PRECAUTIONS: Read the information listed when this function is executed. INPUT: If you allow uploads in only one area (all uploads always go to the same area), then enter that one area letter; otherwise press Enter for all areas. PROCESSING: The options configured in this routine will be saved to a config file PROFILE.Cfg. ** ALT-V: VIEW FILE INFORMATION ------------------------------- FUNCTION: Displays the file information of a file. PURPOSE: Use this to view one individual file's information. PRECAUTIONS: None INPUT: You must enter an exact file name that exists in the database. PROCESSING: A search is performed until the file information is located. NOTE: The first filename that exactly matches the filename you entered will halt the search and that file will be displayed. Although it is not recommended, PRO-FILE does allow duplicate file names. Be aware that in the case that 2 or more files share an identical name, only the first match will be displayed with this function. Use the Global by Area to view the other files' information. ** ALT-H: ON-LINE HELP ---------------------- FUNCTION: Displays a Help Menu with Several Topics to Choose from. PURPOSE: If you're stuck and don't want to exit the program to view the docs, try this. Not all help is available within PRO-FILE, but the most important topics are here. PRECAUTIONS: If you view any one help screen for more than 5 minutes, your hard drive may begin to melt and radioactive ooze may begin to flow from the CPU. INPUT: Just select the help topic and sit back and relax. PROCESSING: PRO-FILE does no real processing on its own. Your brain will hopefully process the information displayed. NOTE: If you are still bewildered after reading the help on-line, read the manual again. The manual has been carefully and painstakingly written to cover every aspect of PROFILE in great detail. ** ALT-X: EXIT TO DOS --------------------- FUNCTION: Returns you to DOS. PURPOSE: This is the only way out of PRO-FILE. That's right.. You can NOT avoid this function. If you want to get out of PRO-FILE, this function is your only means of transportation. Well, this about wraps up this section of the manual. If you read this section carefully, you should be quite familiar with PRO-FILE by now and your brain is probably ready for a rest.. Why don't you take a short break and go play Super Two Card Poker or Spin of Chance. PRO-FILE INSTALLATION ----------------------------- Before you begin to install PRO-FILE, it is highly recommended that you at least read the Foundation section of this manual and quickly scan the Management Tools section before continuing. This will familiarize you with PRO-FILE and installation will be a snap. First, create a sub directory under RA called PROFILE. Place all the PRO-FILE contents in this directory. Be sure to always run PRO-FILE from your PROFILE directory. The first step in the easy installation of PRO-FILE is to initialize a database. You will need to load PRO-FILE. If this is the first time you have run PRO-FILE (and it should be), take a few moments to look around. As you can see, all commands and their corresponding hot-keys are displayed all on one screen - The Main Menu. Now, to initialize the PRO-FILE Database, press Alt-I. If you have RA set up correctly, then PRO-FILE should now be set up correctly. The PRO-FILE portion of the installation is completely automatic. If you receive a message informing you that a new database has been created along with how many areas were initialized, then congratulations! You have created the foundation of your soon-to-be Professional File System. Next, while in PRO-FILE, press Alt-U for Set Up Options. When asked for the areas to scan, hit ENTER for all areas. This is required at first; it can be changed later. So far, all file area information (specifically the file area names and paths) have been set up as you set them up in RA. PRO-FILE has no file information, just area information, so let's get the files set up. If you per chance have decided to take the futuristic plunge from Wildcat to RA, then you are in luck. WMerge, an included external utility, will somewhat convert all your old Wildcat file information to the new database. To use this utility, place the Wildcat file FileSpec.Dat in your PROFILE directory and then type in "WMerge" at the DOS prompt and WMerge will do the rest. All files will be placed in Area A. Because Wildcat does not contain all the extended file info that PRO-FILE keeps track of, some file information will be marked "Not Applicable" until you fill in the missing information yourself. After you run WMerge, go into PRO-FILE and press Alt-F to generate all files bbs files. If you have set up RA or are converting from another BBS software that uses Files.BBS (such as Opus, QuickBBS, and many others), then this will ease the files installation dramatically. All files.bbs files should already be in their appropriate areas. Load PRO-FILE (this should be the second time) and when PRO- FILE begins, it will automatically scan all areas for files not already recorded. (Thus, since no files have been recorded, all files be added.) Because the Files.BBS standard allows only the minimal requirements for a file system, a substantial amount of information can not be gathered. Thus, the extended info that PRO-FILE supports will be missing. It will be your job to fill in the Ratings. In time, PRO-FILE will fill in the rest. Please note that to conserve space, PRO-FILE uses up to two lines only descriptions for its files. Long comments and file descriptions in Files.BBS will be cut short or ignored. So far, the area and file information should be set up. The PRO-FILE portion of the installation is complete. Every RA BBS I've ever encountered uses a multiple file menu system. This means that your RA file menu is divided into a different menu (and possibly a different screen) for each file area. One of the big advantages of PRO-FILE is that if desired, you can break away from the multiple file menu barrier and format the file portion of your BBS to consist of only one file menu (like Wildcat boards are organized). While a single file menu tends to be more convenient for users and will give your board a unique cleverness, it will require a complete overhaul of your file menus and is only recommended only for experienced RA SysOps. Instead of having a different menu and screen for each area, you will have one screen and one menu regardless of how many file areas you have. If you would like to change your BBS to this new set up and have registered RA, skip down a couple paragraphs; otherwise, the following describes how to change all your existing file menus to allow users to view the PRO-FILE listings. You'll need to make one minor change to each file area menu. Use RAMenu to change each Type 31 to a Type 5. At the same time, fill in the optional data field (which should contain a /F or a file path) to read: "Files?". Replace the question mark with the current area letter. If you are confused, remember that PRO-FILE represents areas not only by an area name, but also by a letter (thus, only 26 areas are supported). If you don't know which letter represents the area menu you're editing, then go back into PRO-FILE and select Init Database (Alt-I, the same function you used before.) This time, you'll be asked if you want to modify the database. Select yes and all the areas will be listed with their letter and name. Just hit print screen here and you'll have a hard copy of all your file areas and the letter that corresponds to each. Again, replace the question mark with the letter of each area. (For example, FilesA will list the files in Area A, FilesF will list the files in Area F, on up to Z). This might be a little bit tricky, but you'll be glad to know that is the last installation step. PRO-FILE is now set up and your users will now receive the PRO-FILE Professional File Listings. If you are changing your set up to the more convenient one file menu method, remember that your file system now probably consists of one primary file menu that branches out to several other menus. THE FOLLOWING SET UP CAN ONLY BE ESTABLISHED IF YOU HAVE REGISTERED YOUR COPY OF RA!!!. Delete all the external menus, but first write down or remember what functions were common to each one (such as Downloading, Uploading, New Files Scan, etc). Now, it'll be time to edit or completely start over with your primary file menu. Because it will be easier to just start over, that's what will be explained here. Rename your primary file menu to a back up name so you'll have something to look back to it if you need it. Next, create a new file menu. The bare essentials of this menu should include: * Type 59 - Global Download: This type of download is now required because users won't be changing file areas. Type 33 - Upload: The data field should have a path where you want *ALL* new uploads to go. Type 35 - Keyword Search Type 37 - New Files Type 01 - Goto Menu: This will go to the List Files sub-menu. Of course, you'll want to add an option to return to the main menu or previous menu and an option to log off. Add a type 40 if you display menus by creating screens (like with TheDraw). After you've got these basics set up, go ahead and add any of the additional options you would like. The read text file will not work anymore if you use this set up. Perhaps in a future version of RA, RA will support a Global Read. One last note on the Type 33 (Upload). To use this set up, all uploads must be sent to the same area. You are almost finished. The final step in creating this clever new menu system is to create a sub-menu: The List Menu. The list menu will display all the file areas available and prompt the user for which area to list files in. Just create a menu called List, and for each area you have, add a Type 5. In the optional data field, put the file list to display. In the user display, put the letter and name of the file area. In the hotkey, put the letter of the area. It should be something like this: Type 5 ------ Optional Data Field: FilesA User Display: A - New Uploads Hotkey: A Do this for every area you have and then for the final function on the menu, put a type 1 - Goto Menu (your previous file menu name). The goto(s) are being used instead of the return from gosub (Type 3) to insure that everything goes where it is supposed to. This last function might look something like this: Type 1 ------ Optional Data Field: FileMenu User Display: Select an Area to list or Press [Q] to Quit: Hotkey: Q Remember, Q could be a file area, so if you have enough file areas to use the letters from A-Q, try a different hotkey like - or X. Save the menu as List. It would be a good idea to go back to your main file menu and check the Type 1 and make sure it says List. Finally, go back into PRO-FILE and press Alt-U to Set PRO-FILE up. This time, enter the area letter where all uploads will go to instead of enter for all areas. INSTALLATION COMPLETE!!!!!!!!!!!!!!!!!!!!!!! THE EXCLUSIVE PRO-FILE AUTOMATICALLY DRIVEN COMMAND LINE SYSTEM ------------------------------------------------ Perhaps one of the most convenient and professional features PRO-FILE offers is its Automatically Driven Command Line System (AUTO DRIVE). This system gives you FULL control of every feature in PRO-FILE directly from the command line. Already, you might be able to imagine the possibilities this feature can offer. AUTO DRIVE mainly was designed to allow full control and manipulation over PRO- FILE from a batch file. Because you can use every function (including all interactive functions) of PRO-FILE from the command line or batch file, you can set up PRO-FILE to run completely automatic for days, weeks, even months without even requiring your presence or attendance. The beauty of it all, is that learning and using this system is exceptionally easy. You don't need to memorize dozens of odd parameters and settings and you don't need to worry about placing commands in an absurd order. AUTO DRIVE allows you to communicate easily and effectively with PRO-FILE as you normally would if you were using it yourself. It achieves this simple interface by allowing to use the actual commands you would normally press, ALL ON THE COMMAND LINE! Because this is such a revolutionary and unheard of new idea, a few examples are listed below to illustrate this new system: Below are the actual command lines used.. PROFILE Alt-GA_Alt-X This would Generate the File List for Area A and then exit the program, all automatically. As you can see, if you were to press Alt-G if you ran PRO-FILE yourself, this is the command to Generate Area Listing(s). When you press this in the program, PRO-FILE asks you to press enter for all areas or enter an area letter for just one area list to be generated. Therefore, if you just want area A to be generated, you would press A in the program, so, you'd put A on the command line. Then, PRO-FILE would do it's thing and ask you to press any key to continue. It is important to remember that when PRO-FILE is in AUTO DRIVE, it is in real-time or real-life mode. This means that any and all input that PRO-FILE asks for when you are running the program yourself, it will ask for in AUTO DRIVE also. So, when it asks you to press the space bar to continue, put a space on the command line (but, on the command line, an underscore _ must be substituted for a space). So, in real-time mode, when you press the space bar and PRO-FILE would return to the main menu. From there, you would press Alt-X to exit, so that's what you put on the command line. NOTE: Do not use spaces to separate commands and keypresses. It is not required and will probably cause a malfunction. ** IMPORTANT NOTE ** Remember, when you use AUTO DRIVE, all keys that you would normally enter if you were there must be entered on the command line. This means you've got to be careful and remember that if PRO-FILE pauses and asks you to press the space bar when you run the program yourself, it's going to do the same thing in AUTO DRIVE. Also, this means that if you don't tell PRO-FILE to exit in AUTO DRIVE, then it would normally not exit. However, because it is easy to forget this, a few precautions have been installed to make sure that PRO-FILE will indeed exit at some point to make sure it doesn't lock up your computer. If it is in AUTO DRIVE mode, and it detects that it is out of things to do, then it will automatically exit immediately IF it is at the MAIN MENU. PRO-FILE Alt-DBADFILE.ZIP^YNALT-NBADFILE.ZIP^_ Hmmm, I bet you're thinking this isn't so easy after all, right? Wrong.. The only thing weird about it is that there are a few key substitutions that you must use on the command line. Take the example above. Alt-D would activate the Delete File Function. PRO-FILE would ask you to enter a file name, so you must enter the file name in AUTO DRIVE too. In this case, you enter BadFile.ZIP. If you must press enter to finally enter the filename in real mode, you do in AUTO DRIVE. The carat is used to substitute an enter key on the command line. After you enter the file name, PRO-FILE would display the file information and confirm the process. You would type Y for yes in real mode, so it's there in AUTO DRIVE too. Then, it would ask you if you want to delete it from disk. So, in this example, an N is there, so no, PRO-would not delete the file from disk. Next, PRO-FILE would return to the main menu. In this example, you want PRO- FILE to un-delete it, so ALT-N is there to active the Un-Delete command. Next, of course you enter the filename. PRO-FILE un-deletes it and then asks you to press any key to continue. In this example, that any key is a space and then PRO-FILE returns to the main menu. Now, PRO-FILE is out of things to do and is at the main menu, so the safety feature kicks in and exits the program for you; however, it is recommended that you always put the Alt-X on the command line. This is a pretty silly example, as you would not want PRO-FILE to do this from a batch file, but it illustrates the extreme flexibility AUTO DRIVE offers. The above examples definitely do not illustrate what you will usually be using AUTO DRIVE for, but they do illustrate the flexibility and availability of every function from the command line. The following discusses the most convenient aspect of AUTO DRIVE. PROFILE AUTO This command line would trigger a pre-defined command line. The actual command line to duplicate this function is simple, but AUTO might be easier to remember. The pre-defined command line triggered by a mere "AUTO" on the command line performs a series of processes to perform the most common task in PRO-FILE - To update the database with new information and generate updated area listings. It would be wise to put this command in an event that runs daily or even after each caller logs off. This will keep your listings updated, and you don't need to worry about a thing. The command line you would enter manually to duplicate this function is listed below. See if you can figure out first. PROFILE ALT-CAAlt-X First, as usual, when PRO-FILE loads, it scans the appropriate areas for new uploads and updates the database. Next, it goes to the main menu where AUTO DRIVE takes over. Alt-C activates the Activity Log Scan. This function scans the activity log and then asks if you want to Delete, Not Delete, or Append the activity log. By all means, the Append is the recommended choice, so an A is placed on the command line. PRO-FILE appends the activity log and then returns to the main menu. Because the final step of updating the file lists is to generate them, and this task is automatically performed by PRO-FILE upon exit, it is safe to go ahead and end the program, so an Alt-X is last. One additional item: If you need to press a function key (only F-10 and F-9 are needed in the program), just put F-9 or F-10. More examples and hints on how to use AUTO DRIVE are listed in Q&A.Doc. TECHNICAL SPECIFICATIONS -------------------------------- FILE INFORMATION ---------------- PRO-FILE DataBase File: Files.Bnk Maximum Areas Allowed: 26 ** Area Range: A-Z Maximum Files Per DataBase: Unlimited * Maximum Files Per Area: 500 FILES USED BY PRO-FILE: Files.BBS, Files.RA, Files.Bnk, Config.RA, PROScrn.Dat, PROFILE.Cfg FILES GENERATED BY PRO-FILE: Files.BBS, Files.Bnk, Files.RA, Files?.ASC/ANS, AllFiles.LST/ANS, PROFILE.Cfg * An unlimited amount of records (file information) are allowed in the database, however, only the first 500 records of each area are processed. INCLUDED UTILITIES ----------------- PROFILE.Exe The PRO-FILE Management System (Main File) WMerge.Exe Converts Wildcat's File Format to PRO-FILE's. PROInfo.Exe Door Users can Use On-Line to Receive Further Information on Files. ** Register.Exe Registration Utility designed to ease and speed up registration. ** Registered Version Only Duplicate File Names are allowed, but not recommended.